home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / utility / dxp232.zip / DXP.DOC next >
Text File  |  1994-02-08  |  56KB  |  1,551 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                                             Disk eXPress
  9.  
  10.                                                         The SuperCharged
  11.                                                Diskette Imaging software
  12.                                                         for OS/2 and DOS
  13.  
  14.                                                                      DXP
  15.                                                             Version 2.32
  16.                                                                 02/08/94
  17.  
  18.  
  19.  
  20.                                   TABLE OF CONTENTS
  21.        _________________________________________________________________
  22.  
  23.             1.0. INTRODUCTION TO Disk eXPress ........................3
  24.                  1.1. What is Disk eXPress? ..........................3
  25.                  1.2. Features of Disk eXPress .......................3
  26.                  1.3. New features in Disk eXPress Version 2 .........4
  27.                  1.4. New Disk eXPress companion program: Xtract .....4
  28.                  1.5. What's new in Version 2.10 .....................5
  29.                  1.6. What's new in Version 2.20 .....................5
  30.                  1.7. What's new in Version 2.31 .....................5
  31.                  1.8. What's new in Version 2.32 .....................6
  32.             2.0. SYSTEM REQUIREMENTS .................................7
  33.             3.0. COPYRIGHT NOTICE ....................................7
  34.             4.0. WARRANTY ............................................7
  35.             5.0. COST OF Disk eXPress ................................8
  36.             6.0. CONTENTS OF THIS PACKAGE ............................8
  37.             7.0. SYNTAX ..............................................9
  38.                  7.1. Quick start ....................................9
  39.                  7.2. Disk eXPress help screens ......................11
  40.             8.0. COMMAND LINE SWITCHES DESCRIPTION ...................13
  41.                  8.1. Regular mode ...................................13
  42.                  8.2. Extract mode ...................................15
  43.                  8.3. Diskettes containing bad sectors ...............17
  44.                  8.4. Batch mode support .............................17
  45.                  8.5. Disk eXPress real-time bar graph display .......18
  46.             9.0. EXAMPLES ............................................19
  47.                  9.1. Example 1 ......................................19
  48.                  9.2. Example 2 ......................................20
  49.                  9.3. Example 3 ......................................20
  50.                  9.4. Example 4 ......................................21
  51.                  9.5. Example 5 ......................................21
  52.                  9.6. Example 6 ......................................22
  53.                  9.7. Example 7 ......................................22
  54.                  9.8. Example 8 ......................................23
  55.                  9.9. Example 9 ......................................23
  56.             10.0. ERROR MESSAGES .....................................24
  57.                  10.1. List of error messages ........................24
  58.                  10.2. List of error return codes ....................25
  59.             11.0. LIMITATIONS ........................................27
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.                                                                        2
  76.  
  77.  
  78.  
  79.        1.0. INTRODUCTION TO Disk eXPress
  80.        _________________________________________________________________
  81.  
  82.        1.1. What is Disk eXPress?
  83.  
  84.        Disk eXPress (DXP) allows a diskette image to be created for
  85.        electronic transmission.  Think of it as a way for preparing a
  86.        diskette to be FAXed like a regular document.  Once the diskette
  87.        image is created, it can be transmitted with the use of a modem
  88.        on a regular phone line, or any other electronic networks.
  89.  
  90.        One area of use is to archive diskette images on hard drives or
  91.        tapes.  This can be useful for companies maintaining an
  92.        electronic bulletin board service for clients, in which diskette
  93.        images for the latest hardware drivers, or fixes are available
  94.        for download.  This guarantees the contents of the diskette to be
  95.        the same as the original -- including all directory structures,
  96.        date and time stamps of all the files and directories, and the
  97.        location of any hidden information.
  98.  
  99.        For simple file archival purpose, the use of Disk eXPress should
  100.        be avoided.  The user is encouraged to use one of the many fine
  101.        archive programs available on the market.  Disk eXPress is useful
  102.        for archiving bootable diskettes, diskettes containing hidden
  103.        information, or files and directory entries containing characters
  104.        unrecognizable by the usual file system functions.  Unlike a file
  105.        archive program, Disk eXPress requires a diskette drive and a
  106.        diskette in order to restore any information stored in an image.
  107.  
  108.  
  109.        1.2. Features of Disk eXPress
  110.  
  111.        -  Disk eXPress recognizes all standard 512-byte per sector PC
  112.           style diskettes.  This includes 160K, 180K, 320K, 360K, 720K,
  113.           1.2M, 1.44M, and the latest 2.88M diskettes.  Any internal or
  114.           external diskette drives connected via DOS or OS/2 block
  115.           device drivers are recognized (ie: diskette drives accessed
  116.           via DRIVER.SYS, $FDD5.SYS, etc.)  All information on the
  117.           diskette is saved to a file for electronic transmission, no
  118.           information is lost! (see /a switch for detail).
  119.        -  Disk eXPress can be used for diskette conversion.  For
  120.           example, a 360K diskette image can be restored onto a 720K,
  121.           1.44M, or 2.88M diskette.  If someone sends you a bootable
  122.           360K diskette image, you can restore it onto a 720K diskette,
  123.           and the resulting diskette will be bootable.
  124.        -  Advanced virus protection.  Disk eXPress detects illegal
  125.           program modifications whether it's by virus, or bad electronic
  126.           transmissions.
  127.        -  Multiple 32-bit CRC data protection.  The image is protected
  128.           by several 32-bit CRCs.  In some cases, if a non-critical part
  129.           of the image is modified, the resulting diskette will still be
  130.           usable.
  131.  
  132.  
  133.  
  134.                                                                        3
  135.  
  136.  
  137.  
  138.        -  Upgradability of the self-extracting code.  Disk eXPress
  139.           provides a means to upgrade the self-extracting code within
  140.           the image file for bug fixes, and future code enhancements
  141.           upgrade.
  142.  
  143.  
  144.        1.3. New features in Disk eXPress Version 2
  145.  
  146.        -  Disk eXPress is now a dual mode executable file.  It runs
  147.           under both OS/2 and DOS.  There is only one version of the
  148.           executable as opposed to two in the previous release.
  149.        -  Disk eXPress exploits the multi-threading capability when it
  150.           is run under OS/2.  It performs simultaneous disk I/O and data
  151.           compression.  This typically gives 10 to 50% speed up compare
  152.           to running it under DOS.
  153.        -  Disk eXPress supports long filename for diskette images
  154.           created under OS/2 with HPFS (High Performance File System)
  155.           disk partition.
  156.        -  New data compression algorithm based on a modified Lempel-Ziv-
  157.           Huffman method.  Disk eXPress now compresses smaller than
  158.           version 1, and is also 2 to 3 times faster.  The compression
  159.           rate is comparable to most file archive programs.  Compression
  160.           is dynamic -- non-compressible data is simply stored.
  161.        -  Real-time bar graph display showing current compression rate,
  162.           disk read/write and compression activities (this capability is
  163.           limited under DOS).
  164.        -  Self-extracting diskette image is also a dual mode executable.
  165.           /DOS and /OS2 switches are no longer required (please refer to
  166.           version 1 documentation).  All the extra functions are
  167.           removed, and are now built-into the extract mode of Disk
  168.           eXPress itself.
  169.        -  Disk eXPress can now create non-self-extracting image.  This
  170.           is useful for diskette archival purpose on hard drive or tape.
  171.        -  Diskette decompression code is now built-into Disk eXPress.
  172.           This can be used to decompress version 2 non-self-extracting
  173.           diskette image or Disk eXPress version 1 and 2 self-extracting
  174.           images.  It has the full set of options, including diskette
  175.           formatting, conversion, and verification.  The decompressor is
  176.           also fully multi-threaded under OS/2 to yield the fastest
  177.           diskette extraction time.
  178.        -  The /t switch is added to all the decompressors so that the
  179.           integrity of the image can be tested before committing the
  180.           lengthy diskette write process.
  181.  
  182.  
  183.        1.4. New Disk eXPress companion program: Xtract
  184.  
  185.        -  Xtract is a dual mode executable.  It features all the
  186.           decompression capability of Disk eXPress, including multi-
  187.           threading under OS/2.
  188.        -  It is used for distributing non-self-extracting diskette
  189.           images in which unlimited distribution right is granted for
  190.           Xtract after purchasing a licensed copy of Disk eXPress.
  191.  
  192.  
  193.                                                                        4
  194.  
  195.  
  196.  
  197.        -  Xtract is included in the licensed version of Disk eXPress
  198.           (not included in the shareware version).
  199.  
  200.  
  201.        1.5. What's new in Version 2.10
  202.  
  203.        -  New /q switch for QuickFormatting diskette.
  204.        -  New /DOS switch to create self-extracting images that run
  205.           under DOS and OS/2 DOS box ONLY.  Reduction of 14K overhead in
  206.           self-extracting code.
  207.        -  New /s switch in self-extracting image to bypass warning
  208.           prompt.
  209.        -  Code and compiler optimizations to reduce self-extracting code
  210.           size by 2K and at the same time, achieve a 10% overall speed
  211.           up.
  212.        -  Description can now be entered via environment variables
  213.           (DXPDESC1 to DXPDESC5).
  214.        -  Low level diskette access code has been completely rewritten
  215.           for the DOS side to allow full functionality of Disk eXPress
  216.           under OS/2 DOS box.
  217.        -  Prompt for additional selections ("Format once" and "Format
  218.           all") when a diskette write error is encountered.  This allows
  219.           formatting of just the current track or all subsequent tracks
  220.           before diskette writes.
  221.  
  222.  
  223.        1.6. What's new in Version 2.20
  224.  
  225.        -  Disk eXPress now reads non-DOS diskette.  Diskettes with 512-
  226.           byte sectors and conform to PC physical diskette formats are
  227.           supported.
  228.        -  New 32-bit OS/2 version of Disk eXPress is now included.  The
  229.           32-bit version typically runs 40% faster on the compression /
  230.           decompression thread and is functionally equivalent to the 16-
  231.           bit version.  It also consumes about the same amount of memory
  232.           as the 16-bit version when both are run under OS/2 2.x.  Note:
  233.           the 32-bit version will not run under real DOS.  However, it
  234.           can be launched from the DOS box of OS/2 2.1.
  235.  
  236.  
  237.        1.7. What's new in Version 2.31
  238.  
  239.        -  /fs option for sector skew optimization during diskette
  240.           formatting to allow fastest future diskette read/write speed
  241.           (available only under OS/2).
  242.        -  Threads priority tuning to achieve 5 to 10% increase in speed
  243.           (available only under OS/2).
  244.        -  /d switch for displaying description with self-extracting
  245.           images.
  246.        -  /p switch for specifying pass phrase for encrypting image
  247.           file.  Both the pass phrase and the encryption key are not
  248.           stored in the image file for increased security.
  249.  
  250.  
  251.  
  252.                                                                        5
  253.  
  254.  
  255.  
  256.        -  /w switch for wiping out unused tracks at the end of the
  257.           diskette during image extraction.
  258.        -  /a switch is extended to allow direct specification of non-DOS
  259.           diskette.
  260.  
  261.        1.8. What's new in Version 2.32
  262.  
  263.        -  Wildcard processing for self-extracting code replacement (/r
  264.           switch).
  265.        -  Ability to create diskette image from diskette with bad
  266.           (unreadable) sectors.
  267.        -  Proper saving of image description to a file via I/O
  268.           redirection (dxp image /d > filename).
  269.  
  270.        -  For a list of bug fixes, please refer to the history file
  271.           (DXP.HST).
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.                                                                        6
  312.  
  313.  
  314.  
  315.        2.0. SYSTEM REQUIREMENTS
  316.        _________________________________________________________________
  317.  
  318.        IBM PC, PC-AT, PS/1, PS/2 and 100% compatibles.  Minimum 256K
  319.        conventional memory.  MS-DOS or PC-DOS version 3.20 or above;
  320.        OS/2 1.2 or above, including OS/2 Version 2.x, is required.  Hard
  321.        disk is required for storing large image file.  User must also
  322.        provide the necessary program(s) for sending diskette image files
  323.        through telephone network with the use of a modem, and whatever
  324.        is necessary with any other electronic networks.
  325.  
  326.  
  327.        3.0. COPYRIGHT NOTICE
  328.        _________________________________________________________________
  329.  
  330.        DXP/DXP32 (Disk eXPress)  Version 2.32  02/08/94
  331.        XTRACT/XTRACT32 (Xtract)  Version 2.32  02/08/94
  332.        (c) Copyright 1991-94 by Albert J. Shan.  All Rights Reserved.
  333.  
  334.        No part of this program may be disassembled, modified or altered
  335.        by any means.
  336.  
  337.  
  338.        4.0. WARRANTY
  339.        _________________________________________________________________
  340.  
  341.        I, Albert J. Shan, make no warranties, expressed or implied,
  342.        including, but not limited to, merchantability or fitness for any
  343.        particular purpose.  In no event shall Albert J. Shan be liable
  344.        for indirect or consequential damages arising from the use of the
  345.        software program.
  346.  
  347.        You are free to redistribute this shareware package in its
  348.        entirety.  No part of this package may be included as part of a
  349.        commercial package.  If you have any questions about commercial
  350.        distribution of Disk eXPress, I can be contacted at:
  351.  
  352.        Albert J. Shan
  353.        4620 Granville Avenue
  354.        Richmond, B.C.
  355.        CANADA  V7C 1E4
  356.  
  357.        or via CompuServe, ID 70730,401
  358.        or via Internet, 70730.401@compuserve.com
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.                                                                        7
  371.  
  372.  
  373.  
  374.        5.0. COST OF Disk eXPress
  375.        _________________________________________________________________
  376.  
  377.        The user is granted a 30 days trial period, after which he or she
  378.        is required to register the product.  The cost of a single
  379.        machine license is now $30 Canadian or $25 U.S.  Unlimited
  380.        distribution right of Xtract is granted upon licensing Disk
  381.        eXPress.  Please refer to the file ORDER.FRM or ORDERFRM.US for
  382.        details.
  383.  
  384.  
  385.        6.0. CONTENTS OF THIS PACKAGE
  386.        _________________________________________________________________
  387.  
  388.        The following files are included in this package:
  389.  
  390.            DXP.EXE         - 16-bit OS/2 and DOS executable
  391.            DXP32.EXE       - 32-bit OS/2 executable
  392.            DXP.DOC         - This documentation
  393.            DXP.HST         - History file
  394.            ORDER.FRM       - Canadian and international order form
  395.            ORDERFRM.US     - U.S. order form
  396.            README          - Last minute information
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.                                                                        8
  430.  
  431.  
  432.  
  433.        7.0. SYNTAX
  434.        _________________________________________________________________
  435.  
  436.        7.1. Quick start
  437.  
  438.        The syntax of Disk eXPress is very similar to the COPY command.
  439.        To create a diskette image, type:
  440.  
  441.          dxp drive: filename
  442.  
  443.        To create a diskette from an image file, type:
  444.  
  445.          dxp filename drive:
  446.  
  447.        For example, to create a diskette image from your drive B:,
  448.        simply type:
  449.  
  450.          dxp b: my_image
  451.  
  452.        The file "my_image.exe" will be created when Disk eXPress
  453.        finsihes.
  454.  
  455.        To create the diskette from the self-extracting file created
  456.        above, you type:
  457.  
  458.          my_image b:
  459.  
  460.        OR
  461.  
  462.          dxp my_image.exe b:
  463.  
  464.        Disk eXPress allows command switches to be specified anywhere on
  465.        the command line.  Spaces between command line switches are not
  466.        required.  By default, the file extension is ".EXE" regardless of
  467.        what user specifies.  When creating a non-self-extracting
  468.        diskette image with the /i switch, user is free to choose the
  469.        file extension.  For consistency, the recommended file extension
  470.        to use is ".DXP".
  471.  
  472.        For example, under OS/2 with HPFS drive, a non-self-extracting
  473.        diskette image can be created as follows:
  474.  
  475.          dxp a: "This is diskette 3 of 5.DXP" /i
  476.  
  477.        To create the diskette from the image:
  478.  
  479.          dxp "This is diskette 3 of 5.DXP" a: /f /v
  480.  
  481.        The /f switch tells Disk eXPress to format the diskette a track
  482.        at a time just before each track write.
  483.  
  484.        The /v switch tells Disk eXPress to verify the diskette write
  485.        after the track is written.
  486.  
  487.  
  488.                                                                        9
  489.  
  490.  
  491.  
  492.  
  493.        Note: When using quotes for HPFS filenames, make sure the quotes
  494.        are in front and after if you are specifying a full path:
  495.  
  496.        INCORRECT:
  497.  
  498.          dxp c:\"Disk Image 1.dxp" a:
  499.          c:\images\"Disk Image 2" a:
  500.  
  501.        CORRECT:
  502.  
  503.          dxp "c:\Disk Image 1.dxp" a:
  504.          "c:\images\Disk Image 2" a:
  505.  
  506.  
  507.        To QuickFormat a diskette in drive A:, type:
  508.  
  509.          dxp a: /q
  510.  
  511.        The /s switch may be used to bypass the QuickFormat warning
  512.        prompt.
  513.  
  514.  
  515.        You may stop Disk eXPress at any time by pressing Ctrl-C or Ctrl-
  516.        Break.  The BREAK ON/OFF setting under DOS is ignored.
  517.  
  518.        If Disk eXPress encounters any cluster marked as bad in the File
  519.        Allocation Table, you may receive a warning:
  520.  
  521.         X bad cluster(s) detected in the File Allocation Table.
  522.  
  523.        Disk eXPress will try to recover any unreadable sectors.  If any
  524.        sector is proved to be unreadable, it will store the sector in
  525.        the diskette image with all zeros.
  526.  
  527.        Note:
  528.        Disk eXPress will not detect bad clusters in advance if you by-
  529.        pass File Allocation Table (FAT) scanning by specifying the /a
  530.        switch.
  531.  
  532.        Disk eXPress or Xtract cannnot restore a diskette image onto a
  533.        diskette that contains physically bad sectors.
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.                                                                       10
  548.  
  549.  
  550.  
  551.        7.2. Disk eXPress help screens
  552.  
  553.        Type DXP at the OS/2 or DOS prompt to receive this help screen:
  554.  
  555.         Disk eXPress (16-bit OS/2 and DOS) V2.32  02/08/94  SHAREWARE VERSION
  556.         (c) Copyright 1991-94 Albert J. Shan.  All Rights Reserved.
  557.  
  558.         Regular mode: DXP [options] [drive:] [d:][path]filename
  559.           [options]  /?    Display extract mode help screen
  560.                      /a[c] Read the entire diskette [c = diskette capacity]
  561.                      /d    Input diskette image description (5 lines max.)
  562.                      /DOS  Output DOS only self-extracting executable
  563.                      /i    Output non-self-extracting diskette image
  564.                      /n    Disable data compression
  565.                      /p"s" Specify pass phrase "s = pass phrase"
  566.                      /s    Suppress overwrite prompt
  567.                     drive  Drive letter of the target diskette drive
  568.                  filename  Name of output file
  569.         Valid options with only filename specified:
  570.                      /d    Display description in image file
  571.                      /e    Edit description in image file
  572.                      /r    Replace or add self-extracting code to image file
  573.  
  574.         Note: Items enclosed in [] or "" are optional.
  575.               Diskette must not contain any unreadable sectors.
  576.  
  577.         Supported formats: 160K, 180K, 320K, 360K, 1.2M, 720K, 1.44M
  578.         and 2.88M standard 512-byte sector diskettes.
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.                                                                       11
  607.  
  608.  
  609.  
  610.        Type DXP /?, and you'll get the help screen for the extract mode:
  611.  
  612.         Disk eXPress (16-bit OS/2 and DOS) V2.32  02/08/94  SHAREWARE VERSION
  613.         *** Type DXP by itself to see the regular mode help screen ***
  614.  
  615.         Extract mode: DXP [options] [d:][path][filename] [drive:]
  616.           [options]  /t    Test image file integrity only
  617.                      /d    Display description in image file
  618.                      /f[s] Format target diskette [sector skew optimization]
  619.                      /p"s" Specify pass phrase "s = pass phrase"
  620.                      /s    Suppress overwrite prompt
  621.                      /v    Verify ON (system verify plus read and compare)
  622.                      /w    Wipe unused tracks
  623.                      /c    Convert image onto a higher density diskette
  624.                            (Target diskette must be pre-formatted, and
  625.                             of different form factor.  It also overrides /f)
  626.                  filename  Name of input file
  627.                     drive  Drive letter of the target diskette drive
  628.         Valid option with only drive specified:
  629.                      /q    QuickFormat target diskette
  630.  
  631.         Note: Items enclosed in [] are optional.
  632.               The target diskette must be free of defects (no bad sectors).
  633.  
  634.         Supported formats: 160K, 180K, 320K, 360K, 1.2M, 720K, 1.44M
  635.         and 2.88M standard 512-byte sector diskettes.
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.                                                                       12
  666.  
  667.  
  668.  
  669.        8.0. COMMAND LINE SWITCHES DESCRIPTION
  670.        _________________________________________________________________
  671.  
  672.        When Disk eXPress is used under regular mode for making diskette
  673.        images, the following switches are available:
  674.  
  675.  
  676.        8.1. Regular mode
  677.  
  678.        /a   By default, Disk eXPress reads up to the last allocated
  679.             sector, according to the information it finds in the File
  680.             Allocation Table (FAT) in order to reduce the size of the
  681.             image file.  However, if there is any deleted files at the
  682.             end of FAT that you may want to recover later, the default
  683.             action will prevent you from a successful file recovery.
  684.             Use /a to tell Disk eXPress to create an exact duplicate of
  685.             the original diskette by saving ALL disk sectors to the
  686.             image file.
  687.  
  688.             When Disk eXPress detects non-DOS diskette, this switch will
  689.             be automatically applied.  If you suspect automatically
  690.             diskette sensing is incorrect, you can supply the actual
  691.             capacity of the diskette by speifying /ac, where c = 160,
  692.             180, 320, 360, 720, 1.2, 1.44, or 2.88.  Only the first 3
  693.             characters are checked, so /a1.44M is equivalent to /a1.4.
  694.  
  695.        /d   Prompt user to input description for the diskette image.  A
  696.             maximum of 5 lines of 40 characters each can be stored.
  697.             Disk eXPress bypasses user input, and reads the description
  698.             from the environment variables DXPDESC1 to DXPDESC5, if
  699.             there is at least one defined.  You can also redirect the
  700.             decription input from a file like this:
  701.  
  702.             C:> type desc.txt | dxp a: image1 /d
  703.  
  704.             (Make sure the description text file has exactly 5 lines of
  705.             text in it.)
  706.  
  707.             You can also save the description to a file for editing:
  708.  
  709.             C:> dxp image2.exe /d > desc2.txt
  710.  
  711.        /DOS By default, Disk eXPress creates self-extracting images that
  712.             can be run under OS/2 and DOS.  By specifying this switch, a
  713.             DOS only self-extracting image is created.  The DOS code has
  714.             been written so that it will run under OS/2 DOS box with
  715.             almost no speed penality.  This cuts self-extracting code
  716.             overhead by about 14K.
  717.  
  718.        /i   Create a non-self-extracting diskette image file.  The self-
  719.             extracting code will not be bundled with the resulting file.
  720.             Disk eXPress does not enforce any file extension for non-
  721.             self-extracting diskette image.  For consistency, it is
  722.  
  723.  
  724.                                                                       13
  725.  
  726.  
  727.  
  728.             recommended to use ".DXP" as file extension.  Without
  729.             specifying this switch, the default file extension will be
  730.             ".EXE".
  731.  
  732.        /n   Disable compression.  If the contents of the diskette is
  733.             highly compressed, Disk eXPress may not succeed in
  734.             compressing the data any further.  This can be visually
  735.             inspected when Disk eXPress is run the first time without
  736.             the /n switch.  If the real-time compression rate is very
  737.             low (close to 0%), disabling compression is recommended.
  738.  
  739.        /p   Specify pass phrase for encrypting the image file.  Pass
  740.             phrase can be specified immediately after the switch;
  741.             otherwise, it will prompt you to type in a pass phrase.  The
  742.             pass phrase must be 4 to 64 characters in length.  It is
  743.             case sensitive and spaces can be embedded.  When the pass
  744.             phrase contains space, it can be specified as: /p"Secret
  745.             Pass Phrase".  Special characters can also be entered by
  746.             using the Alt-NumPad key sequence.  For example, if you wish
  747.             to use the "beta" character, you can hold down the Alt key,
  748.             press 225 on the NumPad, and release the Alt key.
  749.  
  750.             Once the pass phrase is used, Disk eXPress will
  751.             automatically encrypt the image data based on the pass
  752.             phrase.  The pass phrase and the encryption key are not
  753.             stored anywhere in the image file, thus making it impossible
  754.             for anyone to find out the pass phrase or the encryption key
  755.             by looking at a binary dump.  The self-extracting image will
  756.             prompt for pass phrase and perform 32-bit CRC checking to
  757.             make sure the image header and the executable code are not
  758.             tampered.  The self-extracting code will not run if it fails
  759.             the CRC test.
  760.  
  761.       NOTE: Data encryption is only as good as the person who uses it.
  762.             Better security can be obtained by specifying a longer pass
  763.             phrase with six characters or more.  It is also the user's
  764.             responsibility to keep the pass phrase in a safe place and
  765.             make it known to the other users who are also using the Disk
  766.             eXPress image archives.
  767.  
  768.             The encryption algorithm used is by no means bullet proof,
  769.             and may not resist cryptanalysis.  However, it is reasonably
  770.             complex to prevent the average computer users from
  771.             deciphering the data.  Better result is obtained if the
  772.             image file is compressed.  If you have sensitive data, the
  773.             use of a more sophisticated encrypter is recommended.
  774.  
  775.        /s   Suppress any overwrite (y/N) prompt.  It assumes an answer
  776.             of 'y' to all prompts.
  777.  
  778.        Three switches are available when no drive letter is specified in
  779.        regular mode:
  780.  
  781.  
  782.  
  783.                                                                       14
  784.  
  785.  
  786.  
  787.        /d   Display the description of the image file.  The full path to
  788.             the diskette image must be specified.
  789.  
  790.        /e   Edit the description stored in an image file.  This is used
  791.             to correct the description later instead of having to redo
  792.             the entire image from scratch.  It will automatically prompt
  793.             you for the pass phrase if the image file is encrypted.  See
  794.             the /p switch on bypassing the pass phrase prompt.
  795.  
  796.        /r   Replace or add extract code to image file.  Filename may
  797.             contain any wildcard characters (ie: ? and *).  If /r is
  798.             used against a self-extracting diskette image, the self-
  799.             extracting code will be replaced with the one stored within
  800.             Disk eXPress.  No backup file is created if the operation is
  801.             successful.  If used against a non-self-extracting image
  802.             file, the self-extracting code will be added, and a new file
  803.             with ".EXE" extension will be created.  The ".EXE" file
  804.             created by this switch is stored in the same location of the
  805.             original image file.  The /DOS, /e, /p and /s switch can be
  806.             used together with this switch.  NOTE: the /e switch does
  807.             not allow the specification of wildcards.
  808.  
  809.             Note: The file extension replacement algorithm simply
  810.             removes any file extension starting after the last '.' and
  811.             then appending "EXE".  Since it is possible to use multiple
  812.             '.' under HPFS, the text after the last '.' is discarded.
  813.             It is advisable to avoid using multiple '.' with HPFS
  814.             filename, and use a space instead.
  815.  
  816.  
  817.        8.2. Extract mode
  818.  
  819.        Disk eXPress can decode and extract 3 types of images: type 0
  820.        (non-compressed), type 1 (Version 1 compression), and type 2
  821.        (Version 2 compression), including non-DOS, and encrypted images.
  822.        When Disk eXPress is used for extracting an image file, the image
  823.        file can be a non-self-extracting image file, or a self-
  824.        extracting executable.  The full path to the image file must be
  825.        specified.  Wild cards are not allowed.  All the switches
  826.        available in the extract mode of Disk eXPress are identical to
  827.        the standalone Xtract program.
  828.  
  829.        /t   Test the integrity of the image only.  Disk eXPress performs
  830.             data decompression (if necessary) and runs through a 32-bit
  831.             CRC computation on the data stored in the image.  It reports
  832.             the stored and computed CRC values.  If these values do not
  833.             match, the image will be bad.  It overrides the
  834.             specification of a drive letter, /f, /s, /v, and the /c
  835.             switch.  It will prompt for pass phrase if the image file is
  836.             encrypted.  See the /p switch on bypassing the prompt.
  837.  
  838.        /d   Display the description of the image file.  The full path to
  839.             the diskette image must be specified.
  840.  
  841.  
  842.                                                                       15
  843.  
  844.  
  845.  
  846.  
  847.        /f   Format the target diskette.  Only standard PC physical
  848.             diskette formats with 512-byte sectors are supported.  If
  849.             /fs is specified, sector skew optimization is performed to
  850.             allow the fastest diskette read/write speed in the future.
  851.             The speed up is anywhere from 10 to 50% depending on the
  852.             hardware.  The formatting time is longer when this option is
  853.             specified.  Sector skew optimization is only available under
  854.             OS/2, and not available in the shareware release.
  855.  
  856.        /p   Specify pass phrase for unlocking the file for various
  857.             operations.  Disk eXPress detects encrypted image file, and
  858.             will automatically prompt for a pass phrase even if this
  859.             switch is not specified.  Pass phrase can specified
  860.             immediately after the switch to bypass the pass phrase
  861.             prompt.  The pass phrase must be 4 to 64 characters in
  862.             length.  It is case sensitive and spaces can be embedded.
  863.             When the pass phrase contains space, it can be specified as:
  864.             /p"Secret Pass Phrase".
  865.  
  866.        /s   Suppress any overwrite (y/N) prompt.  It assumes an answer
  867.             of 'y' to all prompts.
  868.  
  869.        /v   Verify on.  It performs a track verify via operating system
  870.             call, follows by a track read, and a byte-by-byte comparison
  871.             with the original data.  The byte-by-byte comparison is
  872.             added as an extra protection should the CRC test of track
  873.             verify failed to pick up an error.  If disk cache is used
  874.             under DOS, the byte comparison test may not be valid due to
  875.             the fact that the cache is supplying the data with no actual
  876.             read performed on the diskette.  Disk eXPress bypasses disk
  877.             cache when it is run under OS/2.
  878.  
  879.        /w   Wipe unused tracks on diskette during image file extraction.
  880.             Unused space at the end of the target diskette is written
  881.             with hex F6 so that any sensitive data previously written on
  882.             the diskette are erased.  NOTE: this function is not
  883.             available in self-extracting images.
  884.  
  885.        /c   Convert the image onto a higher density diskette.  The
  886.             target diskette must be of different form factor (3.5" to
  887.             5.25" and vice versa, but not 3.5" 720K to 3.5" 1.44M due to
  888.             hardware limitations).  It requires a formatted diskette,
  889.             and will automatically override the /f switch.
  890.  
  891.             Here is a list of all the diskette conversion possibilities:
  892.  
  893.               160K/180K/320K/360K to 720K/1.44M/2.88M
  894.                              720K to 1.2M
  895.                              1.2M to 1.44M/2.88M
  896.  
  897.        /q   QuickFormat of diskette in drive.  This is useful for
  898.             quickly erasing all files on a DOS formatted diskette.  The
  899.  
  900.  
  901.                                                                       16
  902.  
  903.  
  904.  
  905.             File Allocation Table (FAT) and all directory entries are
  906.             erased to zero.  Bad sectors and volume serial are preserved
  907.             after QuickFormatting.
  908.  
  909.  
  910.        8.3. Diskettes containing bad sectors
  911.  
  912.        Starting from version 2.32, Disk eXPress allows the creation of
  913.        diskette images from diskettes containing unreadable (ie: bad)
  914.        sectors.  When Disk eXPress encounters unreadable sectors, the
  915.        following message is displayed:
  916.  
  917.        Read Error: Abort, Retry, Ignore? (a/R/i):
  918.  
  919.        Choose "Retry" to tell Disk eXPress to retry reading the entire
  920.        track of information in one operation, and will re-prompt for the
  921.        above message if any of the sectors on the track is unreadable.
  922.  
  923.        Choose "Ignore" to tell Disk eXPress to retry reading each sector
  924.        on the track in sequence.  Any unreadable sectors will be saved
  925.        as 512 bytes of zeros.  The image header is updated to notify the
  926.        extraction code that the image file in question contains
  927.        unreadable sectors from the previous image built.
  928.  
  929.  
  930.        8.4. Batch mode support
  931.  
  932.        You can use Disk eXPress, Xtract, and self-extracting images in a
  933.        batch file (.CMD file under OS/2 and .BAT file under DOS).  For a
  934.        list of error return codes, please refer to section 10.2 for
  935.        details.  Normally, all display output is sent to standard out
  936.        (stdout), and can be redirected to a file.  Errors and warning
  937.        messages are sent to standard error (stderr).  You can discard
  938.        all Disk eXPress output by redirecting both stdout and stderr to
  939.        NUL (ie: DXP A: MyDisk > NUL 2>NUL).
  940.  
  941.        In addition to entering diskette image description via the /d
  942.        switch, you can also enter the description from within a batch
  943.        file as shown below:
  944.  
  945.        SET DXPDESC1=Disk eXPress
  946.        SET DXPDESC2=Version 2.32
  947.        SET DXPDESC4=(c) Copyright 1991-94 Albert J. Shan
  948.        dxp a: MyDisk /d
  949.        SET DXPDESC1=
  950.        SET DXPDESC2=
  951.        SET DXPDESC4=
  952.  
  953.        Line 3 and 5 are treated as blanks since DXPDESC3 and DXPDESC5
  954.        are not specified.  Batch mode description editing (/e) is also
  955.        supported.
  956.  
  957.  
  958.  
  959.  
  960.                                                                       17
  961.  
  962.  
  963.  
  964.        8.5. Disk eXPress real-time bar graph display
  965.  
  966.        One of the new features of Disk eXPress Version 2 is the use of a
  967.        real-time bar graph display.  Disk eXPress and Xtract will
  968.        exercise the multi-threading capability under OS/2, and you'll
  969.        see a display similar to the following:
  970.  
  971.                                    3%      25%       50%       75%      100%
  972.             Action Rate Track Head ├────────┼─────────┼─────────┼─────────┤
  973.           COMPRESS  52%   37    1  █████████████████▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒
  974.  
  975.        The above bar graph depicts 3 concurrent threads:
  976.  
  977.           ▒ Read thread.  Performs continuous reading of diskette (or
  978.             disk file if it is in extract mode), and releases the
  979.             diskette drive (or disk file) for use by another process
  980.             when reading is finished.
  981.           ▓ Compression/decompression thread.  Compression/decompression
  982.             is performed as soon as data is available from the read
  983.             thread.
  984.           █ Write thread.  Compressed data is written to a disk file (or
  985.             decompressed data written to diskette in extract mode).
  986.             This can be another diskette drive or any block device.
  987.  
  988.        The description under "Action" shows which thread has just
  989.        started executing.
  990.  
  991.        The number under "Rate" shows the current compression rate.  It
  992.        is the percentage reduction with respect to the size of the
  993.        original data.
  994.  
  995.        The numbers under "Track" and "Head" show the current disk track
  996.        and head where operation is being performed.
  997.  
  998.        Since DOS has only one thread of execution, only one bar is
  999.        updated at any time.  Read/Compress/Decompress/Write occurs
  1000.        sequentially.
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.                                                                       18
  1020.  
  1021.  
  1022.  
  1023.        9.0. EXAMPLES
  1024.        _________________________________________________________________
  1025.  
  1026.        9.1. Example 1
  1027.  
  1028.        To pack a 360K diskette in drive B: onto a file called 'disk1'
  1029.        for modem transmission, you type:
  1030.  
  1031.            dxp b: e:\upload\disk1
  1032.  
  1033.        By default, Disk eXPress will automatically append ".EXE" onto
  1034.        the output file name.  If you specify something else as file
  1035.        extension, it will be removed before appending.  If the command
  1036.        line syntax is correct, Disk eXPress will first run a self-check
  1037.        for virus/modification, then it will proceed to create the
  1038.        diskette image.  You'll receive a screen similar to the following
  1039.        after Disk eXPress is finished:
  1040.  
  1041.           360K diskette found in drive B:
  1042.  
  1043.           File Allocation Table statistics:
  1044.           Track 33 head 1 contains the last allocated sector, sector 609.
  1045.  
  1046.                                    3%      25%       50%       75%      100%
  1047.             Action Rate Track Head ├────────┼─────────┼─────────┼─────────┤
  1048.              STORE  28%   33    1  ████████████████████████████████████████
  1049.  
  1050.           32-bit CRC of diskette image is DB49A615
  1051.  
  1052.        By default, Disk eXPress will analyze the FAT and save up to the
  1053.        last sector used on the diskette.  In the above example, it stops
  1054.        at track 33, head 1, because sector 609 is the last allocated
  1055.        sector.  If you have a fragmented diskette, you might receive a
  1056.        screen similar to the following when you run Disk eXPress:
  1057.  
  1058.           1.44M diskette found in drive A:
  1059.  
  1060.           File Allocation Table statistics:
  1061.           Track 36 head 1 contains the last allocated sector, sector 1319.
  1062.  
  1063.           Disk fragmentation detected:
  1064.           814 unallocated sectors will be saved in image
  1065.           (61% of total used sectors).
  1066.           The diskette requires compression for maximum storage efficiency.
  1067.  
  1068.                                    3%      25%       50%       75%      100%
  1069.             Action Rate Track Head ├────────┼─────────┼─────────┼─────────┤
  1070.           COMPRESS  48%   16    0  ██████▓▓▒▒▒▒▒▒▒
  1071.  
  1072.        etc.
  1073.  
  1074.        Running a disk optimization utility on the diskette will help
  1075.        packing files tightly together for maximum storage efficiency.
  1076.  
  1077.  
  1078.                                                                       19
  1079.  
  1080.  
  1081.  
  1082.        Alternatively, you can copy all the files to another freshly
  1083.        formatted diskette so that the files are packed next to each
  1084.        other.
  1085.  
  1086.  
  1087.        9.2. Example 2
  1088.  
  1089.        To save the entire diskette from drive A: (including all the
  1090.        unused sectors) onto the image with compression turned off, you
  1091.        type:
  1092.  
  1093.            dxp /a /n a: e:\upload\disk1
  1094.  
  1095.        You will see this warning if the file exists:
  1096.  
  1097.           Output file E:\UPLOAD\DISK1.EXE exists, overwrite? (y/N):
  1098.  
  1099.        Default action is 'No' for pressing the 'Enter' key.  Type 'y'
  1100.        then 'Enter' to overwrite.
  1101.  
  1102.        To suppress the warning, specify /s on the command line:
  1103.  
  1104.            dxp /a /n a: e:\upload\disk1 /s
  1105.  
  1106.        Notice that you can specify switches anywhere you want on the
  1107.        command line, Disk eXPress will sort them out for you.
  1108.  
  1109.  
  1110.        9.3. Example 3
  1111.  
  1112.        To enter a description when creating an image, you type:
  1113.  
  1114.            dxp b: test15 /s /d
  1115.  
  1116.        You'll see:
  1117.  
  1118.           Please enter diskette description: (5 lines max.)
  1119.             ┌────────────────────────────────────────┐
  1120.           1:
  1121.  
  1122.        You're then prompted to enter a maximum of five lines of
  1123.        description (40 characters for each line).  To enter a blank
  1124.        line, just press Enter.
  1125.  
  1126.        To continue our example, type in the following:
  1127.  
  1128.           Please enter diskette description: (5 lines max.)
  1129.             ┌────────────────────────────────────────┐
  1130.           1: Joe,
  1131.           2: This is the latest beta release of Space
  1132.           3: Commander.  Try it out without a joy
  1133.           4: stick and let me know how it goes.
  1134.           5:   Regards, John
  1135.  
  1136.  
  1137.                                                                       20
  1138.  
  1139.  
  1140.  
  1141.  
  1142.           360K diskette found in drive B:
  1143.  
  1144.           File Allocation Table statistics:
  1145.           Track 33 head 1 contains the last allocated sector, sector 609.
  1146.  
  1147.                                    3%      25%       50%       75%      100%
  1148.             Action Rate Track Head ├────────┼─────────┼─────────┼─────────┤
  1149.              STORE  28%   16    1  ███████████████████▓▓▒▒▒▒▒▒▒
  1150.  
  1151.        etc.
  1152.  
  1153.  
  1154.        9.4. Example 4
  1155.  
  1156.        To change the description of the diskette image created in the
  1157.        last example, type:
  1158.  
  1159.            dxp e:\upload\test15.exe /e
  1160.  
  1161.        The /e switch allows description in the image file to be edited.
  1162.        Note: The /r switch (self-extracting code replacement) can also
  1163.        be specified together with the /e switch.
  1164.  
  1165.  
  1166.        9.5. Example 5
  1167.  
  1168.        Now that you have the self-extracting image, what are you going
  1169.        to do with it?  Simply run it!  To unpack the disk image created
  1170.        in example 3, type 'test15' to see the help screen:
  1171.  
  1172.           Disk eXPress Self-Extracting Diskette Image (OS/2 and DOS)
  1173.           Version 2.32  02/08/94
  1174.           (c) Copyright 1991-94 Albert J. Shan.  All Rights Reserved.
  1175.  
  1176.           Usage: TEST15 [/d] [/s] [/t] [drive:]
  1177.  
  1178.              /d  Display image description
  1179.              /s  Suppress overwrite prompt
  1180.              /t  Test image integrity only
  1181.           drive  Drive letter of a valid floppy disk drive
  1182.  
  1183.           Note: The target diskette must be formatted and must not
  1184.                 have any bad sectors.
  1185.  
  1186.        To finish our example, now type:
  1187.  
  1188.            test15 b:
  1189.  
  1190.        You'll see:
  1191.  
  1192.           ┌────── Diskette Image Description ──────┐
  1193.            Joe,
  1194.  
  1195.  
  1196.                                                                       21
  1197.  
  1198.  
  1199.  
  1200.            This is the latest beta release of Space
  1201.            Commander.  Try it out without a joy
  1202.            stick and let me know how it goes.
  1203.              Regards, John
  1204.           └────────────────────────────────────────┘
  1205.           360K diskette image (Disk eXPress type 2)
  1206.  
  1207.  
  1208.           Diskette in drive B: is about to be overwritten
  1209.           with new information.  Do you wish to continue? (y/N)
  1210.  
  1211.        Default action is 'No' for pressing the 'Enter' key.  Press 'y'
  1212.        then 'Enter' to start diskette image extraction.  The /s switch
  1213.        can be specified to bypass the prompt.  The /d switch can be used
  1214.        alone to display the description in the image.
  1215.  
  1216.  
  1217.        9.6. Example 6
  1218.  
  1219.        To test the integrity of the diskette image without writing out
  1220.        to the diskette, simply type:
  1221.  
  1222.            test15 /t
  1223.  
  1224.        And you'll see:
  1225.  
  1226.           ┌────── Diskette Image Description ──────┐
  1227.            Joe,
  1228.            This is the latest beta release of Space
  1229.            Commander.  Try it out without a joy
  1230.            stick and let me know how it goes.
  1231.              Regards, John
  1232.           └────────────────────────────────────────┘
  1233.           360K diskette image (Disk eXPress type 2)
  1234.  
  1235.           100% Read
  1236.  
  1237.             32-bit CRC stored: DB49A615
  1238.           32-bit CRC computed: DB49A615
  1239.  
  1240.        Note: /t overrides drive letter specified on the command line.
  1241.  
  1242.  
  1243.        9.7. Example 7
  1244.  
  1245.        Now that Joe got the diskette image.  He doesn't have a 360K or
  1246.        1.2M drive (5.25" drive).  All he has is a 1.44M 3.5" drive.  He
  1247.        also happens to have a spare 720K (low-density) diskette he can
  1248.        use.  What can he do?  He can use the /c switch in the extract
  1249.        mode of Disk eXPress or Xtract.  The /c switch can be used to
  1250.        convert the diskette image from 360K to 720K, and all the data
  1251.        will still be intact, and usable.  The diskette used for
  1252.  
  1253.  
  1254.  
  1255.                                                                       22
  1256.  
  1257.  
  1258.  
  1259.        conversion must be pre-formatted.  So, Joe went ahead and
  1260.        formatted the diskette as a 720K diskette, and he types:
  1261.  
  1262.            dxp test15.exe a: /c
  1263.  
  1264.        And receives the following screen (answer y at the prompt):
  1265.  
  1266.         Checking test15.EXE for modifications ... OK.
  1267.  
  1268.           360K diskette image (Disk eXPress type 2)
  1269.  
  1270.         Diskette in drive A: is about to be overwritten
  1271.         with new information.  Do you wish to continue? (y/N) y
  1272.  
  1273.           720K diskette found in drive A:
  1274.         Converting 360K image onto 720K diskette ...
  1275.  
  1276.                               3%      25%       50%       75%      100%
  1277.             Action Track Head ├────────┼─────────┼─────────┼─────────┤
  1278.         DECOMPRESS   20    0  █████████▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  1279.  
  1280.        etc.
  1281.  
  1282.  
  1283.        9.8. Example 8
  1284.  
  1285.        To QuickFormat a diskette, type:
  1286.  
  1287.          dxp a: /q
  1288.  
  1289.        OR
  1290.  
  1291.          xtract a: /q
  1292.  
  1293.        And you'll see:
  1294.  
  1295.        Drive A: is about to be QuickFormatted.
  1296.        Do you wish to continue? (y/N)
  1297.  
  1298.        The default action is 'No' for pressing the Enter key.  The /s
  1299.        switch can be used to bypass the warning prompt.
  1300.  
  1301.        Type 'y' and press Enter and you'll see:
  1302.  
  1303.        QuickFormatting 1.44M diskette ... Done.
  1304.  
  1305.  
  1306.        9.9. Example 9
  1307.  
  1308.        To build a non-self-extracting, non-DOS diskette image, with pass
  1309.        phrase at the same time, type:
  1310.  
  1311.          dxp a: unixboot.dxp /i /p"FoO BaR"
  1312.  
  1313.  
  1314.                                                                       23
  1315.  
  1316.  
  1317.  
  1318.        10.0. ERROR MESSAGES
  1319.        _________________________________________________________________
  1320.  
  1321.        10.1. List of error messages
  1322.  
  1323.        Disk eXPress incorporates 32-bit CRC checking for itself and the
  1324.        image it creates.  In the event of a virus infection or other
  1325.        means of modifications (such as errors in electronic
  1326.        transmissions), the program will abort, and the following message
  1327.        is displayed:
  1328.  
  1329.        *** Executable code has been modified!
  1330.  
  1331.        Here is a run down of major error messages produced by Disk
  1332.        eXPress, Xtract and self-extracting images: (usually a beep
  1333.        followed by one of the following messages)
  1334.  
  1335.        - For bad or not properly formatted diskette during read, write,
  1336.          format or verify (no beep for any Abort, Retry messages):
  1337.  
  1338.          Read Error: Abort, Retry, Ignore? (a/R/i):
  1339.  
  1340.          Write Error: Abort, Retry? (a/R):
  1341.  
  1342.          Write Error: Abort, Retry, Format once, Format all? (a/R/o/f):
  1343.  
  1344.          Format Error: Abort, Retry? (a/R):
  1345.  
  1346.          Verify Error: Abort, Retry? (a/R):
  1347.  
  1348.          *** Bad CRC.
  1349.  
  1350.          *** Sector not found.
  1351.  
  1352.          *** General failure reading drive X:
  1353.  
  1354.          *** Non-standard/unformatted diskette.
  1355.  
  1356.        - When disk is full during image creation (output will be
  1357.          deleted):
  1358.  
  1359.          *** Error writing disk or disk full.
  1360.  
  1361.        - With a write protected diskette during diskette write:
  1362.  
  1363.          *** Diskette is write protected.
  1364.  
  1365.        - When replacing self-extracting code in images with a lower
  1366.          revision level of Disk eXPress:
  1367.  
  1368.          *** Cannot operate on Disk eXPress Vx.xxx image.
  1369.  
  1370.        - When diskette drive is not ready:
  1371.  
  1372.  
  1373.                                                                       24
  1374.  
  1375.  
  1376.  
  1377.  
  1378.          *** Drive X: not ready.
  1379.  
  1380.        - When drive specified is not available or not a diskette drive:
  1381.  
  1382.          *** Invalid drive/path specified.
  1383.  
  1384.          *** Drive X: is not a floppy drive.
  1385.  
  1386.        - When attempting to replace a version 1 self-extracting header
  1387.          with version 2 by the /r switch:
  1388.  
  1389.          *** Cannot operate on Disk eXPress V1.0xx image.
  1390.  
  1391.        - When Disk eXPress or Xtract is asked to extract an unrecognized
  1392.          image file:
  1393.  
  1394.          *** Problem with file: filename
  1395.          Probable cause of problem:
  1396.  
  1397.          1. File is not a Disk eXPress image file,
  1398.          2. Image file has been modified,
  1399.          3. Image file was created by a special version of Disk eXPress.
  1400.  
  1401.        - When Disk eXPress or Xtract is asked to convert a diskette
  1402.          image to the same form factor diskette:
  1403.  
  1404.          *** Conversion not supported on target diskette.
  1405.  
  1406.        - When pass phrase entered is incorrect upon an image extraction:
  1407.  
  1408.         *** Incorrect pass phrase, operation aborted.
  1409.  
  1410.        - Some error messages returned by Disk eXPress are displayed as:
  1411.  
  1412.          *** Error n, Drive X:
  1413.  
  1414.        In such event, please document the procedure on how to get to the
  1415.        above error, and contact me as soon as possible.
  1416.  
  1417.  
  1418.        10.2. List of error return codes
  1419.  
  1420.        The following is a list of error return codes produced by Disk
  1421.        eXPress, Xtract, and self-extracting images:
  1422.  
  1423.        Code Number    Cause of Error
  1424.             0         Operation successful, no error found.
  1425.             1         No operation is performed; such as the displaying
  1426.                       of help screens.
  1427.             2         Incorrect Operating System version.
  1428.             3         User abort by answering 'N' to a (Y/N) type
  1429.                       prompt.
  1430.  
  1431.  
  1432.                                                                       25
  1433.  
  1434.  
  1435.  
  1436.             4         User press Ctrl-C or Ctrl-Break to abort program.
  1437.             5         Memory allocation error (Program error).
  1438.             6         Cannot create thread under OS/2 (check THREADS= in
  1439.                       OS/2's CONFIG.SYS).
  1440.             7         Other system errors.  The actual return code is
  1441.                       displayed on the screen as: *** Error n, Drive X:.
  1442.             8-9       Reserved.
  1443.             10        Drive specified is not a floppy drive.
  1444.             11        Invalid Drive or path specified.
  1445.             12        Uncertain media in drive (non-standard/unformatted
  1446.                       diskette).
  1447.             13        Diskette Drive not ready.  No diskette in drive,
  1448.                       or drive is in used by another program.
  1449.             14        Diskette is write protected.
  1450.             15        Disk write error or disk full.
  1451.             16        CRC Error.  Possibily due to bad diskette.
  1452.             17        Sector not found.  Possibility due to bad
  1453.                       diskette.
  1454.             18        Diskette Format error.  Possibily due to bad
  1455.                       diskette.
  1456.             19        General failure.  Possibily due to unformatted
  1457.                       diskette.
  1458.             20-29     Reserved.
  1459.             30        Cannot open file.  Either it is not found or in
  1460.                       used by another program.
  1461.             31        Bad image file header.  Image header failed CRC
  1462.                       test.
  1463.             32        File is corrupted possibily due to error in
  1464.                       electronic transimssion or infection by virus.
  1465.             33        Bad image file CRC.  Possibily due to error in
  1466.                       electronic transmission.
  1467.             34        Incorrect image file version.
  1468.             35        Unknown image type.
  1469.             36        No files found for /r switch processing.
  1470.             37-39     Reserved.
  1471.             40        Diskette and image file mismatch.
  1472.             41        Cannot format diskette due to diskette/image file
  1473.                       mismatch.
  1474.             42        The diskette capacity specified in /a is not
  1475.                       acceptable for the diskette drive.
  1476.             43        Cannot convert image file to the requested
  1477.                       diskette format due to floppy hardware limitation.
  1478.             44        Cannot QuickFormat diskette because it is not a
  1479.                       DOS formatted diskette.
  1480.             45        Incorrect pass phrase entered for unpacking the
  1481.                       image file.
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.                                                                       26
  1492.  
  1493.  
  1494.  
  1495.        11.0. LIMITATIONS
  1496.        _________________________________________________________________
  1497.  
  1498.        Diskette images created by Disk eXPress version 2 are not
  1499.        compatible with version 1 images.  Replacement of version 1 self-
  1500.        extracting code with the /r switch is not allowed.
  1501.  
  1502.        When Disk eXPress is used to create a self-extracting diskette
  1503.        image, the extract code is bundled as an overhead for each image
  1504.        created.  The overhead is currently at 25K (11K for DOS only
  1505.        image).  This is acceptable, considering the size of any non-
  1506.        trivial diskette image is usually quite large (in the order of
  1507.        several hundred kilo bytes or even mega bytes).  25K should
  1508.        require about two minutes for a 2400 baud modem to transfer, and
  1509.        with a 14.4K V.32bis modem, the transfer time is about 16
  1510.        seconds.
  1511.  
  1512.        Other limitations include the inability to read a diskette drive
  1513.        over the LAN (limitation of the network driver), and Disk eXPress
  1514.        over any copy protected programs.  Another limitation is its
  1515.        inability to read over physically bad sectors.
  1516.  
  1517.        Any suggestions and comments are welcome.  Suggestions for new
  1518.        features may eventually be incorporated into a future release.
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.                                                                       27
  1551.